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Summary This section describes the way in which you access the system, 

beginning with system Installation and proceeding through user 
registration, login, and the use of menus and commands to 
request system functions. 
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INTRODUCTION 



You can request access to the system to perform a number of 

different functions, such as: 

• System building - Configuring the system tc the needs of Its 
users. 

• System administration - Registering users. 

• Operation control - Starting up the system each day, 
controlling processing, managing peripheral devices, and 
monitoring system status. 

• Program development - Compiling, testing, and debugging 
programs. 

• Application execution - Interacting with a program to 
accomolish a particular task. 

In a large installation, different individuals will perform 
different functions. In a small installation, one person may 
perform most or all of the functions. 

Access to the system 1s restricted to authorized users by means 
of the registration and login processes. Access to system files 
is restricted to specified users through the access control 
process (described in Section 2). Access to the various system 
facilities is controlled through the menu or command 
environment. 

Before any access to the system can be made, the system must 
first be configured. 
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SYSTEM CONFIGURATION AND DEFINITION 

Creation cf a system is a four-step procedure, consisting of: 

1. 




2. Bootstrapping a Honeywell Bull suoolied system startup 
routine that provides a irnited operating environment *or 
building the files used in the third step. 

3. Specializing the system startup procedure by configuring a 
system' to correspond to the installed hardware and by 
defining the environment in which to prepare and execute 
application programs. 

4. Making a backup copy of the disk containing your specialized 

system. 

System Installation 

Honeywell Bull delivers to you one of the following: 

1. A disk containing an installed operating system and 
requested application software. You use this dis< to 
bootstrap tne startup routine, 

2. a LOAD/SAVE Diskette and a disk or tape containing the 
operating system and other application software you 
ordered. The LOAD/SAVE software guides you in installing 
the operating system onto your system disk. The 
installation process is described in detail in the Softwa r e 
Installation Guide r . Once the operating system software 
resides on your sy'stem disk, you bootstrap the startup 
routine. 
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Bootstrap 



The bootstrap operation consists of turning on the 
to the hardware, mounting the disk containing the 
software, and pressing several keys on the control 
System Control Facility device. (The procedure is 
the System User's Guide.) The bootstrap operation 
initial configuration and startup operations. The 
limited, one-user, on-line environment permits you 
system startup so that subsequent bootstraps will 
multi-user environment that is adapted to your sit 
requirements. This initial configuration may also 
develop or execute application programs; however, 
procedure is to generate a site-specific configura 
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Configu- 
ration 



To generate a site-specific configuration, ycu either Invoke 
the Autoconfigurator (DPS 6/22 only) or you create a file 
(called the CLM.USER file) containing the Configuration Load 
Manager (CLM) directives that describe the operating environment 
that will exist at your installation. The CLMJJSER file is 
created automatically by the DPS 6/22 Autoconfigurator. The 
configuration directives are described in the System Building 
and Administration manual. 

START-UP. EC To further define the environment, you can create a STARTJJP.EC 
file (>>START_UP.EC) containing the operator commands that 
perform installation-specific functions such creating buffer 
pools. A »STAR T J!P.EC file is created automatically by the 
DPS 6/22 Autoconfigurator. (STARTJJP.EC files are described 
later in this section.) 

After the CLMJJSER file and the system STARTJJP.EC file are 
created, you again bootstrap the system. This time, the 
directives in the CLMJJSER file control the configuration, and 
the operator corrmands in the system STARTJJP.EC file further 
define the operating environment. 

System Backup Copy 

You should make a backup copy of the specialized system disk. 
Either the Copy utility or the Save and Restore utilities can be 

used for this purpose. 
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USER REGISTRATION 

User User registration is a process what protects the system from 

Information unauthorizec access. Each person who is tc be allowed on the 
system must be registered by trie system administrator (that is, 
a user whose account is SYS_ADMIN). The administrator uses the 
Edit Profile command tc specify user-specific information such 
as: 

• User id. (Identifies the user for system purposes. 
Consists of two or three parts; person. account[ .mode]. 
Uppercase ana lowercase characters are equivalent: 
JONES. ADMIN and Jones. Admin are the same user id.) 

• Login id. (Identifies tne user for login purposes only. 
Contains no periods. Uppercase and lowercase characters are 
distinct; JONES and Jones are cifferert login ids.) 

• Default login 1 ine 

• Login traits, Including: 

- Single or multiuser profile 

- Secondary user profile 

- Login only with default login line 

• Whether a password is required to log in 

• For single-user profiles, whether statistics such as the 
following are to be kept for the user: 

- Number of sessions 

- Total elapsec time 

- Accumulated system resource usage. 

Profiles This user-specific registration information is stored in a 

File profiles file. The profiles file contains the user profiles for 

all registered users. The system checks the user profile when 
monitoring the privileges and/or limitations o* each user. 

On the DPS 6/22, the Autoconfiguratcr creates a default profiles 
file that you can customize to meet your special requirements. 
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Profile User profiles are made up of sections, each of which describes a 

Sections specific interface to some part of the system. A user profile 

always contains a registration section (consisting of the 
information listed above plus the optional user statistics, If 
specified). It can also contain one or more of the following 
sections: 

• Comments section. Contains any comments the system 
administrator has about this user's registration. 

• Subsystem sections. Contain user-specific information 
meaningful to Individual subsystems. Examples of subsystem 
sections are: 

- The Office Processing section (WP), which contains 
information such as the default print queue assigned to 
the user. Users must be registered with this subsection 
to use the ONE PLUS menus, 

- The ONE PLUS Menu Subsystem section (OP), which contains 
information such as the first menu the user is allowed to 
see. Most users will be registered with this subsection. 

- The Menu User section (MU), which contains information 
about the User Productivity Facility menus. Users who 
will be creating their own menus, or who will be 
executing system commands through menus and forms, must 
be registered with this subsection. 

Viewing The List Profile command allows registered system users to view 

Profiles the contents cf their user profiles. It allows a system 

administrator to view any registered user's profile. 

Refer to the ONE PLUS System Administration manual for details 
on user registration.. 
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ACCESSING THE SYSTEM 

Access to the system requires: 



A physical connection between your terminal and the central 
processor 

• A logical connection between ycu and the Executive. 

Connecting to the Central Processor 

Two types of terminal connections are possible: a direct 
connection and a dialup connection. 

Direct In a direct connection, the terminal is connected to the 

Connection central processor when the terminal's POWER switch is turned ON 
and its ONLINE/OFFLINE switch is set to ONLINE. 

Dial up In a dialup connection, the terminal is connected to the 

Connection tc the central processor after a telephone number is dialed on 
the terminal '5 modem. 

The same terminal can be used both as an operator terminal and 
as a user terminal . 

Refer to the System User's Guide for further information on 
physical connections. 

Connecting to the Executive 

Listener You can access a terminal in one of two ways, depending on 

whether or not the terminal is configured for login. Terminals 
configured for login are reserved for access to the system 
through a system component called the Listener. Such terminals 
cannot be directly reserved by system applications. Terminals 
not configured for login are not monitored by the Listener and 
can be directly reserved by system applications. (Refer to the 
System Building and Administration manual for details on 
configuring the Listener and Listener terminals-) 

Systems are more secure when all terminals are monitored by the 
Listener. 
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Login Terminals 

Login Types When a terminal is monitored by the Listener, either a login 
form or a banner line is displayed when the connection to the 
central processor is made. You can connect to the Executive 
through one of the following login methods: 

• Forms login. Fill out the login form and, if required, 

enter the designatec password. 

• Full login. Type the Login command and, if required, enter 
the designated password. 

• Abbreviated login. Type the 1-character login abbreviation 
and, if required, enter the designated password. 

Another login method, direct login, requires no action on your 
part beyond turning on the terminal ana, If required, entering 
your designated password. 

Terminals The system builder defines those terminals that the Listener 

File monitors through entries in a file called the terminals file. 

(On the DPS 6/22, the Autoconfigurator builds a terminals file 
that you can modify for special requirements.) The terminals 
file is used to specify the following information: 

• Maximum number of concurrently logged-in users to be allowed 
on the system. 

• Whether the terminal is to display a login form or a 
banner. The Autoconfigurator selects the login form for all 
terminals. 

• Name of each terminal that can be used as a login terminal 
(plus, for direct login terminals, the login line to be used 
when the terminal is turned on). 

• Each 1-character login abbreviation and its associated login 
line. 

• Other information about the system and specific terminals. 
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Non-Login Terminals 



An application can be activated, with a terminal designated for 
the mout of the commands and/or data required by the 
application. When this terminal is physically connected to the 
system, no banner or form is displayed. In most cases, you can 
start entering data immediately. The screen display and your 
response depend on the application. 

A login terminal can be changed to a non-login terminal (and 
back aga-n) by the Set Listen command. 



Activated Lead Task 



When you gain access to the system, the executable code for the 
lead task (the controlling task of the application) is loaded 
and activated. The lead task can be designated to be the 
Command Processor, the Menu Processor, or an application. When 
the Command Processor is the lead task, you can control 
execution by issuing any user command described in the Coimands 
manual. When the Menu Processor is the lead task, you can 
control execution by filling out screen forms. When an 
application is the lead task, neither the Command Processor nor 
the Menu Processor is part of the task group. 

MENU ENVIRONMENT 

The ONE PLUS Menu Subsystem provides an easy-to-use interface to 
MOD 400. You can access all MOO 400 components, inducing 
electronic mail, document processing, data base management, and 
system utilities from one master menu (called the PLUS menu). 

=LUS Menu The PLUS menu groups the system 'unctions according to 

category. For example, the menu's Document Services category 
includes functions such as document processing, library 
operations, index operations, and queue operations. If you want 
to create a .document, you select Document Services on the PLUS 
menu and, when the Document Services menu is displayed, you 
select Document Processing. You specify a particular document 
processing operation by selecting that operation on the Document 
Processing menu and filling out the fielcs of the form that is 
displayed as a resu't of your selection. 

Messages Each selection on a Honeywell Bull supplied menu, and each form 

fielc that may oe fiiied-in, has an associated help message. To 
obtain help in fining in a field on a form, press the key 
designated as the help key fcr your terminal. When the help key 
is pressed, a help message is displayed below the menu or form. 
If you make a mistake in filling in a field, the system provides 
exDanded er^or messages that list causes and corrective actions 
to aid in resolving the problem. 
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User Applications 



The Menu Subsystem allows you to select user applications from 
the PLUS menu. To be able to do this, you must have added your 
applications to the Menu Subsystem. You can add, delete, and 
modify a menu, form, or message through the following tools: 

• Menu Maintenance to create, modify, or delete menus. 

• Forms Developer (VISION) to create, modify, or delete forms 

• Generalized Forms Processor (DFC) to use standard forms in 
applications. 

• Add/Delete Message utility to update the message library. 

• Table Maintenance utility to build or modify tables used to 
process forms. 

The Application Development Overview describes the process of 

developing user menus and ferns. 



System Commands 



The Menu Subsystem allows you to use menus to execute system 
commands. To operate in this way, you select User Productivity 
Facility from the System Services menu. The User Productivity 
Facility contains a set of menus arranged according to command 
category. You select system commands by choosing options listed 
on the menus and then filling in the fields on one or more 
associated forms. When all appropriate fields have been filled 
in, the command is generated and executed. 

The Menu Subsystem also allows you to enter command lines 
directly. To operate in this way, you select Command Line from 
the System Services menu. (For information on command usage and 
format, refer to the Commands manual.) 



Menu Processor 



The Menu Processor is the system software component that reads 
the Honeywell Bull supplied menus and forms you fill in. After 
reading a form (or command line), the Menu Processor loads and 
executes a bound unit that fulfills the request represented by 
the form. 

The Menu Frocesscr uses the standard system files {corrmand-in, 
user-in, user-out, and error-out). Refer to "Command 
Environment" for a complete description of these files. 
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Menu/Form Level 



When tne system is In a state in which it is capable of 
displaying a menu or form, it is said to be at menu/form level 



Achieving Menu/Form Level 



The Listener can spawn tas< groups whose lead tasks are the Menu 
Processor. Note that the system is delivered with a Honeywell 
Bull supplied user task group ($H) whose lead task is the 
Command Processor (described later in this section). 

The system Indicates 1t is at menu/form level by displaying a 
menu or form- 



Menu/Form Level Processing 

When you fill out a Honeywell Bull supplied menu and press the 
EXECUTE key, the system displays anotner menu or a form. When a 
form is displayed, you enter the necessary cats and press the 
EXECUTE key. T he function you requested is executed. 

Command When the system generates a comnand, it uses the data you 

Execution entered. Once the command has been generated, the system 

performs the following steps: 

1. Spawns a task naming the requested bound unit (the bound 
unit named by the generatec command). Task spawning implies 
task creation, wh ; cn consists of the allocation and 
initialization of any control structures ano data areas 
required for task control. 

2. Calls the Loader to load the requested bouno unit. 

3. Places a reauest for the execution of the bound unit against 
the created task. The Menu Processor enters the wait state 
to await completion of the requested task (comnand). At 
this point, the system leaves menu/form level, which car be 
returned to only by completior of command execution. 

4. If the command is Enter Group Request, places a group 
request against an application task group. The Enter Group 
Request command terminates. The request is queued if there 
are other outstanding requests against the application task 
group from previous Enter Group Request commands. 

5. Deletes the spawned task when the corrmand cerm'nates. 
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COMMAND ENVIRONMENT 



The cormiand environment is that environment in which you 
communicate with the Executive through command lines entered at 
a terminal or read from a command file. 

When you use the menu environment, you make a choice from a menu 
and enter data into the fields of the form that is displayed m 
response to your menu selection. In the command environment, 
however, ycu directly enter a command line that contains all the 
necessary information in the form of arguments. 

The description of the command-in, user-in, user-out, and error- 
out files given below also applies to the menu environment. In 
addition, the information under the heading "Command Format" 
applies equally to commands entered under the menu environment. 

Command Processor 

The Command Processor is the system software component that 
reads your command lines. After reading a command line* the 
Conntand Processor loads and executes a bound unit that fulfills 
the request represented by the command line. 

The essential parts of the command environment are the Command 
Processor and the command-in file. Three other files are also 
involved with the command environment. These are the user-in 
file, the user-out file, and the error-out file. The four files 
associated with the Command Processor are also referred to as 
the standard I/O files. 

Command-In The command-m file 1s the file from which the command lines 
File are read. It can be a terminal device, as in the case of an 

interactive user, or a command file residing on a disk, as 1n 

the case of a non-interactive user. 

User-in The user-in file is the file from which a command, during its 

File execution, reads its own input. When a task group request has 

been processec, and as long as no alte-nate user-in file is 
specified as an argument in the subsequent command, the user-in 
file remains the same as the command-in file. At the 
termination of a command that names an alternate user-1n file, 
the user-in file reverts to Its initial assignment. 
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For example, the directives submitted to the line editor 
following the entry of the Editor command are submitted througn 
the user-in file. No specific action is required on your part 
to activate or connect to the u$er-in file unless the directives 
are to be read from a previously created disk file. You simply 
invoke the line editor and begin entering line editor directives 
through the same terminal. The attaching of the terminal to the 
user-in file is invisible to you. 

User-Out The user-out file is the file to which a task group normally 

File writes its output. However, certain system components (for 

example, compilers) also write to list files (path.L) or to the 
output file defined in the -COUT argument of the cormand that 
invokes the component. 

The user-out file is initially established t>y the -OUT argument 
of the Enter Group Request or Spawn Group command. Originally, 
it 1s the same device as the error-out file device. It can be 
reassigned tc a file or another device by use of the File Out 
conrnand or New User Out system service macrocall. Such a 
reassignment remains in effect for the task group until another 
reassignment occurs. 

Again using the line editor as an example, any responses from 
the line editor, such as the printing of a line of the file 
being edited, are issued through the user-out file. As in the 
case of the user-in file, you need not perform any special 
action to attach your terminal to the user-out file. The only 
time such action would be required is if you wanted to direct 
tne output from the command to some device other than the 
terminal. 

Error-Out The error-out file is used by the system to corrmunicate any 

c ile error condition that may be detected during the interpretation 

of a command or its subsequent execution. Such a condition 
could be a missing command argument (reported by tne Command 
Processor} or a file-not-found condition (reported by the 
invoked command) . 

The error-out file is originally the same as the original 
user-out file; it can be reassigned tc a file or another device 
by use of the File Out command. 



Command Level 



When the system is in a state in which the Command Processor is 
capable of accepting a command from the coirmand-in file, it is 
said to be at command level. 
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Achieving Command Level 



You can achieve command level by creating or spawning a user 
task group whose lead task is the Command Processor. The 
Listener can also spawn task groups whose lead tasks are the 
Command Processor, The system is delivered with a Honeywell 
Bull supplied user task group ($H) whose lead task is the 
Command Processor. 

The system indicates it 1s at command level by Issuing a "ready" 
prompter message at your terminal. (This assumes that you have 
not disabled the reacy message by issuing a Ready Off command. 
If Ready Off has been issued, the system comes to command level 
without informing you.) If you are working in the system task 
group ($S) at the operator terminal, no ready prompt message 
appears unless you issue an EC (CONSOLE command followed by a 
Ready On command. 



Command Level Processing 



When you enter a command, the system performs the following 
steps: 

1. Spawns a task naming the requested bound unit (the corrmand 
name). Task spawning implies task creation, which consists 
cf the allocation and initialization of any control 
structures and data areas required for task control. 

2. Calls the Loader to load the requested bound unit. 

3. Places a request for the execution of the bound unit against 
the created task. The Corrmand Processor enters the wait 
state to await completion of the requested task (command). 
At this point, the system leaves corrmand level, which can be 
returned to only by completion of command execution or by 
pressing the BREAK key. 

A. If the command is Enter Group Request, places a group 

request against an application task group. The Enter Group 
Request command terminates. The request is queued if there 
are other outstanding -requests against the application task 
group frorr previous Enter Group Request commands. 

5. Deletes the spawned task when the command terminates. 
Optionally issues a ready message to indicate a return to 

comrand level , 
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When executing a coinrand function, you ;an return to command 
levei in any cf the following ways: 

• Normal commanc termination. At normal termination of a 
command function," the task group returns to command level 
anc awaits the entry of another command. (If your terminal 
is not monitored by tne Listener, you should not enter the 
Bye command.) 

• Commanc interruption- You can interrupt the execution of an 
invoked corrmanc oy pressing tne BREAK key (which may be 
labeled with BREAK or BRK) on the terminal. The system 
responds to this action with the break message "BREAK**. 

At this ooint, you can enter other commands or can enter the 
Start conmand tc resume processing at the point of 
interruption. (Refer to the Commands manual for details.) 



Command Format 

A conmand line is a string of up to 252 ASCII characters in the 

form: 

cormand.name [arg .'..arg ];corrmand_name [arg ...arg ] ... 
in in 

where commandjiame is the pathname of the bound unit that 
performs the command's function. Arguments, designated by arg, 
are described below. 

Multiline A command line can spar one or more physical lines. A command 

C omnan c s line is concatenated with the next line by ending it with an 

arnpersanc (&). A command line consisting of two or more 
concatenated lines can be canceled by entering a single 
ampersand on the next physical line. 

Multicorrmand More than one command can be included in a command line by 
Lines ending eacn command (except the last) with a semicolon (;). If 

any conmand in the conmand line is prematurely terminated 
(interrupt or error), the remaining commands are not processed. 
Note that only one ooerator conmand can aopear on a line. {An 
operator command is a command that can be entered only by the 
person at the operator terminal.) 
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Arguments 



Positiona 

Argument 



Control 
Argument 



An argument of a command is an individual Item of data passed to 
the task of the named command. Some commands require no 
arguments; others accept one or more arguments as indicated in 
the syntax of each command description. The types of arguments 
used are positional and control. 

A positional argument is an argument whose position in the 
command line indicates to wnich variable the item of data is 
applied. The argument can occur in a command line Immediately 
after the command name, or as the last argument following the 
control arguments, as in the List Names command. 

A control argument is a keyword whose value specifies a 
command option. A keyword is a fixed-form character string 
preceded by a hyphen (for example, -ECL). It can be alone, as 
in -WAIT, or it can be followed by a value, as in -FR9M xx. 

Except for -ARG, or when the last argument of a command line is 
a oositional argument, keywords of control arguments can be 
entered in any order in the line, following the initial 
positional arguments. The keyword -ARG must be the last 
argument cf the command line. The arguments following -ARG are 
passed to the activated (application) task. 



Parameters 



Arguments are the user-selected items cf data passed to a task. 
In the activated task, which is written in a generalized manner 
to handle any set of data passed to 1t, these data items are 
known as parameters. If the activated task expects positional 
parameters, the command line arguments passed to it must be in 
the same order as the task's positional parameters. 



Spaces in Command Lines 



Arguments in corrrna-d lines are separated f r om each other by 
spaces. Unless otherwise indicated, a space in command line 
syntax represents one or more space characters, one or more 
horizontal tab characters, or a combination of space and 
horizontal tab characters. You can embed spaces within an 
argument by enclosing the argument in apostrophe (') or 
quotation mark (") characters. Note that a file name supplied 
in an argument can be shown to have a trailing space if the 
argument is bounded by quotation marks. 
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Protected Strings 

Seme characters (called reserved characters) have special 
significance to the Command Processor, if you want to use these 
characters without their special significance, you must protect 
them by placing them between protected string designators. 

Reserved Special significance is attached to the following reserved 

Characters characters; 

• Space (blank) 

• Horizontal tab 

• Quotation mark (") 

• Apostrophe (') 
t Semicolon ( ;) 

• Ampersand (&) 

• vertical bar (|) 

• Left bracket and right bracket ([]) 

Designators it is occasionally necessary to use a reservec character without 
its special meaning (for example, a blank could be used in a 
eoimiand argument). The protected string designators (apostrophe 
and Quotation mark) are reserved for this purpose. Reserved 
characters within a protected string (cne surrounded by 
protectee string designators) are treated as ordinary 
cnaracters. For example, in the argument: 

-ARG "ALPHA 2" ALPHA 

the space in ALPHA 2 is treated as part of the name. 

Unless the Uppercase cormiand specified that uppercase was cff T 
lowercase characters that are not protectee by quotation marks 
are interpreted as upper case characters. For example, if 
uppercase is .off, the string abed w ; ll be passed tc a commanc as 
ABCD and the string "abed" will be passed as abed. 

Use of the protected string designates may also be required 
when the & character is followed by a numoer in a command-in 
file. If &1 does not represent a substi tutable parameter, it 
must be written as &'l' or &"i" (not "&:•'). Substitutable 

parameters are discussec in the Carmancs manua' and J r the 
System User's Guide, 



3-18 C2C3-02 



System Access 



Suppressing Since the protected string designators themselves are reserved 
Designators characters, it may be desirable at times to suppress their 
special meaning. To do this, you must enclose the string 
containing the reserved character in quotation marks or 
apostrophes. If the reserved character to be protected is the 
same as the characters enclosing the string, it must be entered 
twice. For example, to pass the string A"B to a command, you 
can enter either cf the following: 

■"flung* 

•A-'B' 

To pass the string A'B to a command, you can enter one of the 

*ol 'owing: 

•A' "B 1 
"A'B" 



Active Strings and Active Functions 

An active string is a part of a command and is evaluated 
(executed) immediately by the Command Processor, The resulting 
value is then substituted for the active string characters in 
the command line. Any corrmand can be used within an active 
string. Commands explicitly designed to be used within active 
strings are called active functions. Active strings and active 
functions are delimited by left and right brackets. 

An example cf an active function is [EQUAL a b], which returns 
TRUE if a is equal to b and FALSE if a is not equal to b. 
Another example is [LHD], which returns the full pathname of 
your home directory, if you issued the command: 

MENILPR [LHD]>MENJCAT.EN -LC 

the system would list all the menus in the menu catalog in your 
home directory. 

Active functions can have arguments of their own, and active 
strings can be nested. For example, the TIME active function 
(which returns the current time as hour and minute) can be 
nested in the SUBSTR function (which returns a substring of 
characters beginning at a specified position and including a 
specified number of contiguous characters). If TIME returns 
10:15, the active string: 

[SUBSTR [TIME] 4 2] 

returns the substring 15 (begin at fourth character and return a 
substring of two characters). 
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An active string can consist of any number of valid active 
functions separated by semicolons. The value of the active 
string is the concatenation of trie values of the active 
functions. For example, if the active string [act_fncl x] 
returns the value TURN, and the active string [act_fnc2 yi] 
returns the value OUT, the active string: 

[act_fncl x; act_fnc2 yi] 

returns the value TURNOUT. 

Active strings and active functions are described in detail in 
:he Commands manua' . 



Command Abbreviations 

Abbreviation ""he abbreviation processor provides a way cf relating a short, 
Processor user-cefinea character string to another string of arbitrary 

length. Suppose, for example, that a program existed in a 
directory other than your working directory and had several 
entry points (called ALPHA, BETA, and OMEGA) that performed 
different functions. Entering the full pathname of the program 
and its entry point would require you to type an involved 
command line sucn as: 

>PROoECTA>SMITH>SUB_DlR>WIDGET?ALPHA 

each time you wished to invoke function ALPHA in program WIDGET 
in the directory identified as >PROJECTA>SMITH>SUB_DIR. The 
abbreviation processor a Tows you to define a simple name such 
as ALPHA and equate it to the full command pathname. Similar 
abbreviations can be defined for functions BETA and OMEGA. 

Abbreviation You can create and maintain your own standard sequential file of 
File abbreviations for commonly used commands, control arguments, and 

pathnames. When the abbreviation processor has been activated 
oy the Abbreviation command, it intercepts a command line, uses 
your abbreviation file to expand any abbreviations in the 
corrmand line to their predefined character strings, and then 
passes the full corcmand line to the command processor. 
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COMMAND ACCOUNTING 



Command accounting is an optional facility that logs all user 
commands entered through the command language, menus, and the 
Process Corrmand Line system service macrocall. Commands entered 
from system groups (those whose first group 1d character 1s $) 
^r^ not logged. 

The system records the command's elapsed time ana resource usage 
as well as the group id and user id of the issuer. Refer to the 
System Building and Administration manual for information on 
recuesting command accounting and obtaining command accounting 
repcrts. 



COMMAND BEAMING 



CommanC beaming allows you to execute commands in another 
compute- system (node). (A tesk grouo capable of processing the 
commands you enter Is automatically created in the remote 
node.) When you issue a Beam command, the system's remote file 
access facility (described in Section 2) reads your command-In 
and user-in files and sends the data to the node specified in 
the Beam command. The output generated at this node is written 
to your user-out ana error-out files. All subsequent commands 
you issue will be executed at the specified node until you issue 
ancther Beam command to return to your node. 

All memory space, processor time, and disk space required to 
execute the commands are distributed to the remote node. 

Since command beaming allows you into another computer, you can 
enter commands to find out the status of users, applications, 
devices, and so forth on that node. You can queue requests, 
send messages to local users, and update the node's remote file 
catalog. 
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EC AND START UP.EC FILES 



The Command Processor is able to read commands from a source 
other than an interactive user terminal. One example is an 
Execute Command (EC) file that ycu construct through an editor. 
An EC file is a text file that contains command lines (for input 
to the Command Processor) anc/or Execute cormand directives. An 
EC file is read 5y the Command Processor when: 

• The Command Processor is invoked by an Execute conmand. 

• A task group is activated witfi the Comnand Processor as Us 
lead task and the EC file is soec^fied as the task group's 
user-in file. 

Absentee When you enter a request to have a task run in absentee mode. 

TasK you specify an EC file that is tc be read by the Commanc 

Processor (refer to the System User's Guide for further 

details). 



EC Files 



An EC file might contain a series of commands that you execute 
on a frequent basis, sucn as commands to execute a set of 
app'ication programs that run at the end of the month to ■ 
summarize inventory, sales, and accounts receivable. EC files 
can range from simple to comolex. An examole of a simple EC 
file is: 

ED -PT 

FCR'RANA AREA -LE 

LINKER AREA -IN LNKDR 

DPRINT AREA.M 

AREA 

This EC file is made up of commands that are most often used in 
developing a FORTRAN program called AREA. The =D commanc 
invokes the line editor, FORTRANA invokes the t-e FORTRAN 
compi'er, LINKER invokes the Linker, DPRINT pn-ts the \ i r-< nap 
and AREA executes the program. 
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A more complex EC file uses active functions and substitutafale 
parameters. The following file could be used to create, 
compile, and link any program. (The lines beginning with the & 
character are Execute command directives.) 

& CREATE, COMPILE, AND LINK A &1 PROGRAM 

&P BEGIN EDITOR SESSION 

ED -PT 

&P COMPILATION BEGINS 

&1 &2 

&IF [EQUAL [RETCODE] 0000] &THEN &ELSE &> ERROR1 

&P LINKER SESSION BEGINS 

LA 

LINKER &2 

LINK &2 

QT 

SO 

SIF [EQUAL [RETCODE] 0000] &THEK &ELSE &> ERROR1 

&P LINK COMPLETE 

&> FINISH 

&L ERROR1 

&P ERROR ENCOUNTERED IN DEVELOPMENT SEQUENCE 

&> EC TERMINATED 

&0 

&L FINISH 

&Q 

Assuming that this file* is named PROG_QEV.EC, you could execute 
it for a COBOL program development session by entering: 

EC PR0G_DEV COBOLM PAYROL 

The pathname element ,PROG_DEV 1s substituted for all occurrences 
of &0 (none in this example), COBOLM is substituted for all 
occurrences of &1, and PAYROL is substituted for all occurrences 
of 42. 

The EC command is described in the Cormands manual; EC files are 
discussed in the System User's Guide, 
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START UP.EC Files 



A soecia' amplication of EC files is the ; r jse at systeir 
initialization anc at "ask group activation. 



System STARTJJP.EC File 



After configuration (after the CLMJJSER file of configuration 
directives is executed), the system searches for a user-written 
command file named START_UP.EC tn the system root directory. !f 
this file is present, it is executed. 

A typical system startup EC file might contain operator commands 
used to establisn an application environment for the 
installation. An example of such a file is: 

CBP BUFFI -BUF 10 -CI5Z 102* 

CBP BUPF2 -BUF 5 -CIS2 512 

CBP BUFF3 -BUF 5 -CIS2 256 

CBP BUFF4 -BUF 2D -DIR 

START.MAIL 

EC »GR0UPSL 

&0 

This startup EC file creates several Buffer pools of various 
common sizes, activates the local mail /message facility, and 
activates Listener monitoring of terminals. 
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User START UP.EC File 



When a task group whose lead task is the Command Processor is 
activated, the Command Processor searches for an EC file named 

home_directory>START_UP.EC 

where hoire_di rectory is the pathname specified in the -HD 
argument of the user registration (or the -WD argument of the 
Spawn Group command). If such a file is present, the Command 
Processor executes it before performing any other action. 

When a task group whose lead task is the Menu Processor is 
activated, the Menu Processor searches for an EC file named 

home_directory>$TART_ONE.EC 

and, if such a file is present, executes it before performing 
any other action. 

The user startup EC file could contain commands to direct the 
execution of the tasks of the job and/or perform certain 
housekeeping tasks. An example of a user startup EC file is: 

5T 2 -EFN PROGA 
5T 3 -EFN PROGB 
ST 4 -EFN PROGC 

This user startup EC file causes three tasks to be activated. 
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